home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir25 / mm801.zip / IMPORTF.DOC < prev    next >
Text File  |  1994-03-20  |  5KB  |  109 lines
  1.  
  2.  
  3.                 MEAL-MASTER IMPORT FILE SPECIFICATIONS
  4.  
  5.  
  6. The Meal-Master import function is designed to import recipes that
  7. were exported from the program.  However, the export format is a
  8. simple text file that can be created by most text editor programs.
  9. Many people have found that recipes from other sources can be edited
  10. to look like a MM export file, allowing them to be imported to MM with
  11. little or no retyping.  The format required is described below.
  12.  
  13. FIXED FORMAT (LINES 1 THROUGH 6)
  14.  
  15.   Line 1  The first line of a valid recipe is a "recipe header" line.
  16.           This line must begin with at least 5 hyphens ('-----'), and
  17.           must contain the words "Meal-Master" somewhere on the line.
  18.           Any lines found prior to this "recipe header" line will be
  19.           ignored by Meal-Master.
  20.           
  21.           (Note: If this line is missing, Meal-Master will attempt to
  22.           locate the "Title: " line described below, and continue with
  23.           the import process.  However, it is recommended that header
  24.           lines be used when possible)
  25.  
  26.   Line 2  The word "Title:" must begin the line in any position before
  27.           column 7, and be followed by one blank space.  The recipe
  28.           title must start after the blank space, and may be a maximum
  29.           of 60 characters in length.
  30.  
  31.   Line 3  The word "Categories:" must begin the line, in any position,
  32.           and be followed by one blank space.  A maximum of 5 category
  33.           names may be entered, beginning after the blank space.  A
  34.           comma should immediately follow each category name except
  35.           the last one; for example "Cakes, Desserts".  Category names
  36.           should start with a capital letter, with the remaining
  37.           characters in lower case letters.
  38.  
  39.   Line 4  A numeric quantity between 1 and 9999 (number of servings)
  40.           must appear somewhere on this line.
  41.  
  42.  
  43. VARIABLE FORMAT - LINES 5 AND GREATER
  44.  
  45.   Beginning with line 5, Meal-Master will attempt to identify each
  46.   line as being an ingredient line, direction line, or the "end of
  47.   recipe" trailer line.
  48.  
  49.   If a line is found that starts with 5 hyphens, and contains no
  50.   characters other than hyphens and spaces, the program considers this
  51.   the "end of recipe" trailer line.  It will store the current recipe
  52.   and begin searching for another "recipe header" as described in
  53.   "Line 1" above.
  54.  
  55.   If all the following are true, the line will be interpreted as an
  56.   ingredient and loaded into Meal-Master:
  57.  
  58.      1) Positions 1-7 contain a valid numeric quantity, either
  59.         expressed as a whole number, decimal fraction, or common
  60.         fraction, or are blank.
  61.  
  62.  
  63.      2) Positions 9-10 contain one of the valid Meal-Master unit of
  64.         measure codes, including blanks. (see list in program).
  65.  
  66.      3) Positions 12-39 contain text for an ingredient name, or a "-"
  67.         in position 12 and text in positions 13-39 (the latter is a
  68.         "continuation" line for the previous ingredient name).
  69.  
  70.   If all the following are true, the line will be interpreted as an
  71.   ingredient heading line:
  72.  
  73.      1) Positions 1-5 contain hyphens ("-----").
  74.  
  75.      2) The line is at least 40 characters long.
  76.  
  77.      3) The center three characters of the line are not blank or
  78.         hyphens.
  79.  
  80.      Note: The easiest way to format a line that will be accepted as a
  81.         heading is to start with 5 hyphens, then the heading text,
  82.         then some other special character (like "=" or "@") to at
  83.         least position 40.
  84.  
  85.   If the line does not qualify as an ingredient line, heading line, or
  86.   end of recipe line, as specified above, data in positions 3-77 (or
  87.   1-75 if positions 1-2 are non-blank) will be imported as a direction
  88.   line.
  89.  
  90.   Note: One of the most common errors in formatting a recipe for
  91.   import is an ingredient line that has been improperly formatted.
  92.   When this is encountered, the line is usually interpreted as a
  93.   direction line by the program.  To help guard against this, the
  94.   program will display an error message if it finds a line that
  95.   appears to be a direction line FOLLOWED by a valid ingredient line.
  96.  
  97.   Note: A less common error is starting a direction line in positions
  98.   12 or 13.  Such a line "looks" like an ingredient line with no
  99.   quantity or unit of measure, so an error message is given if it is
  100.   found in the Direction section.  Make sure that direction lines
  101.   start before column 12 or after column 13.
  102.  
  103. Files can contain multiple recipes, so long as each begins with a
  104. "header line" and ends with a "trailer" line.  Any text in the file
  105. that is not between the header and trailer lines is ignored.
  106.  
  107. NOTE:  THIS SPECIFICATION IS ONLY VALID FOR MEAL-MASTER VERSION 7.0
  108.        AND HIGHER, AND WILL NOT WORK PROPERLY WITH EARLIER VERSIONS.
  109.        PLEASE OBTAIN VERSION 7.0 OR GREATER FOR PROPER RESULTS!